package cn.iocoder.yudao.module.promotion.service.rankinglist;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.promotion.controller.admin.rankinglist.vo.RankingListDeatilRespVo;
import cn.iocoder.yudao.module.promotion.controller.admin.rankinglist.vo.RankingListPageReqVO;
import cn.iocoder.yudao.module.promotion.controller.admin.rankinglist.vo.RankingListRespVO;
import cn.iocoder.yudao.module.promotion.controller.admin.rankinglist.vo.RankingListSaveReqVO;
import cn.iocoder.yudao.module.promotion.controller.app.rankinglist.vo.AppRankingListDetailRespVo;
import cn.iocoder.yudao.module.promotion.controller.app.rankinglist.vo.AppRankingListUserInfoRespVo;
import cn.iocoder.yudao.module.promotion.dal.dataobject.rankinglist.RankingListDO;

import javax.validation.Valid;
import java.time.LocalDateTime;

/**
 * 活动排行榜 Service 接口
 *
 * @author 万民匠心
 */
public interface RankingListService {

    /**
     * 创建活动排行榜
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createRankingList(@Valid RankingListSaveReqVO createReqVO);

    /**
     * 更新活动排行榜
     *
     * @param updateReqVO 更新信息
     */
    void updateRankingList(@Valid RankingListRespVO updateReqVO);

    /**
     * 删除活动排行榜
     *
     * @param id 编号
     */
    void deleteRankingList(Long id);

    /**
     * 获得活动排行榜
     *
     * @param id 编号
     * @return 活动排行榜
     */
    RankingListDO getRankingList(Long id);

    /**
     * 获得活动排行榜分页
     *
     * @param pageReqVO 分页查询
     * @return 活动排行榜分页
     */
    PageResult<RankingListDO> getRankingListPage(RankingListPageReqVO pageReqVO);

    /**
     * 查询当前进行中的排行榜活动
     * @param now 当前时间
     * @return
     */
    RankingListDO getRankingListNow(LocalDateTime now);


    /**
     * 根据id查询APP排行榜活动详情
     * @param id
     * @return
     */
    AppRankingListDetailRespVo getAppRankingListDetailById(Long id);


    /**
     * 根据id查询排行榜活动详情
     * @param id
     * @return
     */
    RankingListDeatilRespVo getRankingListDetailById(Long id);

    /**
     * 根据排行榜活动id和用户id查询用户积分
     * @param id
     * @param userId
     * @return
     */
    AppRankingListUserInfoRespVo getMyRankingListDetailById(Long id,Long userId);
}